home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 016a / comp2.zip / COMPARE.DOC < prev    next >
Text File  |  1992-01-26  |  3KB  |  55 lines
  1.  
  2. COMPARE v. 1.0 -- Perform bytewise comparison of two files.
  3.         Copyright (c) 1992 DeurAble Software.
  4.  
  5. FUNCTION:
  6.      As indicated above, COMPARE checks two user-specified files for internal
  7. differences.  It's similar to DOS's COMP command, but does not stop after ten
  8. differences are found.  It also doesn't support the command line parameters
  9. that COMP does, primarily because I didn't need them for my application.
  10.  
  11. USAGE:
  12.      COMPARE <file1> <file2>
  13.  
  14.      Full file names and extensions are required.
  15.  
  16.      The two files need not be the same length; if they differ in length,
  17.      COMPARE stops checking after reaching the end of the shortest file.
  18.  
  19.      If fewer than two file names are given, or either file cannot be opened,
  20.      an error message is displayed.
  21.  
  22. OUTPUT:
  23.      COMPARE's output is sent to the monitor; it can be routed to a third
  24. file using the DOS ">" director command (e.g., COMPARE IN1.DAT IN2.DAT >OUT).
  25. The listing shows the names of files being compared, and the nature and
  26. location of each detected difference.  A sample output is below:
  27.  
  28. Comparing contents of files      IN1.DAT and IN2.DAT . . .
  29.      Byte at offset    3261 (0CBD)    00 --> 02
  30.      Byte at offset    3264 (0CC0)    09 --> FF
  31.      Byte at offset    3265 (0CC1)    04 --> 00
  32.      Byte at offset    3266 (0CC2)    0A --> 1F
  33.      Byte at offset    3267 (0CC3)    04 --> 00
  34.      Byte at offset    3268 (0CC4)    04 --> 00
  35.      Byte at offset    3269 (0CC5)    08 --> 03
  36.                        ^|^^  ^|^^     ^|     ^|
  37.                         |     |        |      +-- Value of byte in File2 (Hex)
  38.                         |     |        +--------- Value of byte in File1 (Hex)
  39.                         |     +------------------ Location of byte, in Hex
  40.                         +------------------------ Location of byte, in Decimal
  41.  
  42. DISCLAIMER:
  43.      While this program SHOULDN'T do any harm to any disk or system, I make
  44. no guarantee of its safety or suitability for your task.  It opens the input
  45. files for reading only, so should be incapable of writing to them.  It does
  46. not do much input buffering, though, so you will see quite a bit of file
  47. access, particularly on large files.  If you use a Ramdisk, it might ease your
  48. mind to copy the input files there before running COMPARE on them.
  49.  
  50. DISTRIBUTION:
  51.      This program is released as Freeware.  Use it, copy it, give it away as
  52. a birthday gift.  Just don't alter it.  If you circulate it, please bundle it
  53. with this document.  Any comments or suggestions can be left for Dwight Deur
  54. in the RIME Shareware conference.
  55.